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I. INTRODUCTION 

First of .all/ don't be put off by the size of this document. The 
appendices make up the major portion/ and they are mostly tables of 
information organized for reference. 

This paper is intended for users experienced with ned. "E" is a 
second-generation descendent of "ned"/ and although it is similar to 
ned/ it incorporates some changes that mill totally confound you if 
you try to use it before reading this. It should be noted that this 
document has only limited use for those mho log directly into E/ 
bypassing the UNIX shell (future Text Processor users). 

Ned was put through a metamorphosis to fix all known problems/ to 
make it easier to learn/ and to add many new and powerful features for 
experienced users. What came out of all that is the new editor 
described here: "E". Perhaps the best news for the user is that 
recovery after a crash is done automatically for you. The best news 
architecturally might be that E is virtually unlimited regarding the 
addition of new commands. Ned relied almost totally on function keys 
(colored keys) to invoke commands. But the number of function keys is 
limited/ and therefore the number of commands was limited. Z, 
however/ has one command key called <CMD> that can process a.1 1 
commands and to which new commands can be added. E also utilizes 
almost all the function keys too/ so you can choose which way you 
prefer to invoke many commands. E has other advantages/ the vast 
majority of which has been attained without losing the nice things 
about ned. In fact/ much of ned has been retained. 

The penultimate appendix of this document lists in some detail 
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(almost) every command available with E. The last appendix is a chart 
of commands available with the new <CMD> key. 

MAJOR CHANGES FROM NED 

E is different from ned in three major ways: 

1) the <AR6> (argument) key has now become the <CMD> (command) key; 

2) a few of the special function keys (colored keys) are now used 
differently; 

3) the <PUT> key has now become the <MARK> key. 

Eventually these particular keys will be physically replaced at your 
terminal so that/ for example/ the key that now says arc on it will 
say CMD. For the time being/ however/ just remember that when you 
press the <ARG> key you will see "CMD:" on your screen. 

This document devotes one section to each of these three major 
changes. 

DOCUMENT SYNTAX 

For the purposes of this document/ the following syntax has been 
adopted: 

1. Capital letters inside "< >" are function keys (colored 
keys) . 

Examples: <RETURN>/ <OPEN>/ <+PAGE>. 
The one exception to this is the <CTRL> key/ or the 
control key. It is always used in conjunction with 
another key so its syntax here includes that other key. 
For example/ <CTRL-S> means hold down the <CTRL> key as 
you press the key with S on it (this will move the text 
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window over to the right as it always did). 

2. <n> means a decimal number. 

Examples: 10/ 2/ 35. 

3. <area> means a specified area mithin the window in lines 
or paragraphs and/or columns. 

Examples: "3p" or "3P" (3 paragraphs), "31" or "3L" 
(3 lines), "31x70" or "3Lx70" <a rectangle 3 lines 
down and 70 colujnns across)/ "3px70" or "3Px70" <a 
rectangle 3 paragraphs down and 70 columns across). 

4. <cursor> means any sequence of cursor movements. 

5. Other lower case letters inside "<>" mean a word or phrase 
of that type. 

Example: <filename>. 

6. Letters or words inside "C3" indicate options. 

Example: C<area>3. 
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II. RUNNING E 

To edit a file, type "e" instead of "ned". 

Example: 

% e <f i iename> 
When E calls up a file, it first puts out a message like "e rev 10 is 
starting...". This lets you knoui that you can start typing ahead at 
that point. 

If you call up a new file, one that you haven't created before, 
an empty window will appear and below it E will ask, "Do you want to 
create <new filename>?" if you do, type the single letter "y" .or "Y" 
and the window will open for your use. 

E refrains from clearing the screen until it has to, and does not 
clear the screen upon exit. 
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III. <CMD> KEY 

The biggest change E incorporates is the <CMD> key (known in the 
past as the <ARG> key)/ which can invoke any command. When giving a 
command with the <CMD> key, the syntax is always the same: Hit the 
<CMD> key/ type out your command(s) with area and/or option(s)/ then 
hit the <RETURN> key or other function key: 

Example: 

<CMD> f il 1 <RETURN> 
This will fill one paragraph of text. 
As with ned/ one paragraph is the default for fill/ 
justify* and center. 

When you type this command/ you will notice that "CMD:" appears 
on your screen right below the bottom window line/ just as "ARG:" used 
to. We will refer to that line as the "Command Line". The line 
directly below the Command Line is now referred to as the Info Line/ 
and that is where the word "■INSERT" appears when you press the < INSERT 
MODE> key. If you use the <MARK> key (more later)/ the word "MARK" 
will also appear on the Info Line/ next to where "INSERT" appears. 

With the <CMD> key* your typed-out command can be abbreviated as 
long as the abbreviation is unambiguous. While we are on the subject 
of abbreviations/ some comands take options/ and they can be 
abbreviated also. Upper and lower case are not distinguished for 
command names and their options. 

Ex amp 1 e : 

<CMD> fi <RETURN> 
This will also fill one paragraph. 

If you want to override the default of one paragraph/ right after 

you type out the command/ type out the area you wish the command to 
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mork on. 

Examples: 

<CMD> fi 31 < RETURN > 
This will fill three lines down from the cursor. 

<CMD> fi 5 <RETURN> 
or: 

<CMD> fi 5p < RETURN > 
This mill fill five paragraphs down from the cursor. 

Every command invoked by function keys (colored keys) is now also 
available through the <CMD>. key. For example, you can open or close 
lines as before by hitting the <OPEN> or <CLOSE> keys. But in E you 
can also type out these commands with the <CMD> key. 

Example: 

<CMD> open <RETURN> 
This will open one blank line. 
(As with ned, one line is the default for the 
<OPEN>, <CLOSE> and <PICK> function keys and, as above, 
when these functions are typed out with the <CMD> key.) 

Some commands are no longer available on function keys. You used 

to exit from ned by hitting the <DEL> key. You can't do that anymore; 

now you exit via the <CMD> key. (No longer will exit if you 

accidentally hit the <DEL> key when you intended to hit < RETURN >. ) 

Example: 

<CMD> exit < RETURN > 

This will exit you from E and update your files. 

Besides the familiar commands in the examples above, E 

incorporates some entirely new commands to be used with the <CMD> key 

(see Appendix D). 
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TO GET OFF J.HE COMMAND LINE 

a) If you hit the <CMD> key and then decide you don't want to 
give a command* simply hit the <RETURN> key. "CMD:" on your screen 
mill disappear and your cursor mill move from the Command Line back 
into the text window for editing. 

to) If you have hit the <CMD> key, typed out a command, and then 
decided you don't want to give the command, backspace over the typed- 
out command and then hit <RETURN>. 

Or type <CTRL-C>, which will wipe out the Command Line with 
the command in it, and move your cursor back into the text window. 
<<CTRL-C> is now the "Interrupt" key. More on that later.) 

TO ABORT A COMMAND 

You have hit the <CMD> key, typed out your command, and hit 
<RETURN>, only to change your mind. You want to abort the command as 
it is working. Hitting <CTRL-C> (the interrupt) will do this. The 
interrupt works on searches and the following commands: run, feed, 
fill, justify, and center. 

NOTE: Typing within the text window while the command is executing 
will not automatically abort the command, as was true in the latest 
ned. Therefore, you no longer have to wait for a command to complete 
execution before typing ahead. 
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THE COMMAND MODE 

The notion of "Command Mode" has been created. If you give this 
command: 

<CMD> command <RETURN> 
your cursor mill stay on the Command Line so that you can give 
continuous commands. When you wish to return your cursor to the text 
window* type: 

<CMD> -command <RETURN> 
This facility may be withdrawn later if it is not found useful. 
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IU. FUNCTION KEYS 

Some of the meanings for function keys (colored keys) have been 
changed or deleted. Examples of this have been noted above/ including 
<CTRL-C>/ which used to mean "change windows" but now means 
"interrupt/" and the <DEL> key/ which used to exit you from ned but 
now has no meaning. <DEL> is only biding its time/ however; it will 
be used later/ when we get to some of the Features of the Future. The 
other function key with a big change is <60T0>. It used to take you to 
a specified line number/ but now it has become the <REPLACE> key. 
More on that later. 

Below is a listing of each function key/ what it used to do in 

your text window/ and what it does now under E. 

FUNCTION KEY OLD USE NEW USE 

<ARG> Introduced arguments Is now the <CMD> key 

for functions. (see <CMD> KEY section). 

<+TAB> and Moved the cursor to Same/ except that they don't 
<-TAB> next tab setting. wrap around any more/ and they 

won't take you all the way to 
a border unless there is a 
tabstop there. 

<BS> Backspaced to erase Same/ plus: 

text. To erase text to left of 

cursor on cursor line/ hit: 
<CMD> <BS> 

with INSERT Mode off. 
To close text to left of 
cursor on cursor line/ hit: 
<CMD> <BS> 
with INSERT Mode on. 

<DEL> Exited user from ned. Has no use now. 

To exit from E and 
save your file/ type: 
<CMD> exit <RETURN> 

To exit and abort the changes 
you made/ type: 
<CMD> exit abort <RETURN> 
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< RETURN > 



Returned the cursor 
to first column* 
next line. 



Same* but also executes 
<CMD> key commands (see 
<CMD> KEY section). 



<HOME> 



Moved cursor to upper 
left-hand corner of 
text window. 



Same* plus: 

To move cursor to lower 
left-hand corner* type 
<CMD> <HOME> 



Arrows 



Moved cursor around 
screen. 



<GOTO> 



Moved the text window 
to the beginning of 
the file. With <ARG> 
moved to the end of 
the file or to a 
specific line number. 



Same* plus: 

Cursor no longer wrap 
window. 

If you are at the bot 
a window* and you hi 
<down arrow> 
the screen will scro 
Similarly for the ot 
directions. 

You can use <left arr 
<right arrow> on the 
Line. 

To move cursor to the 
text on current line 
<CMD> <right arrow> 

If you are beyond end 
on current 1 ine* 
<CMD> <right arrow> 
takes you to rightmo 

To move cursor to col 
of current line* hit 
<CMD> <left arrow> 

To move cursor to lin 
same column* type: 
<CMD> <up arrow> 

To move cursor to bot 
window* same column* 
<CMD> <down arrow> 
(If the end of the f 
before the bottom of 
you will stop there* 
get to the bottom of 
by typing 

<CMD> <down arrow> 
again. 



Is now the <REPLACE> key. 

See section on replacing 

Appendix C. 
To move to the beginning 

of the file* type: 

<CMD> goto b <RETURN> 

or 

<CMD> <-PAGE> 



s around tf 

torn line oi 
t 

11 up. 
her three 

ow> and 
Command 

end of 
* hit: 

of text 
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e 1 
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type: 
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and you c< 
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<+PAGE> 
<-PAGE> 



and 



Moved the text window 
forward or backward 
one page. 



To move to the end of 
the file* type: 
<CMD> goto e <RETURN> 
or 
<CMD> <+PAGE> 

To move to a certain 
line number^ type: 
<CMD> goto <n> <RETURN> 
<CMD> goto <n> <RETURN> 

Same. 

To move the window forward 

4 pages/ type: 

<CMD> 4 <+PAGE> 
Backward 2 pages would be: 

<CMD> 2 <-PAGE> 



<+LINE> 
<-LINE> 



and 



Moved the text window 
forward or backward 
11 lines. 



Same. 

To move the window forward 

4 lines/ type: 

<CMD> 4 <+LINE> 
Backward 2 lines would be: 

<CMD> 2 <-LINE> 



<+SCH> 
<-SCH> 



and 



Searched through 
text for a given 
word or string. 



Same. 

Use <CMD> key as you 

used <ARG> before. 

For example/ 

<CMD> <text> <+SCH> 

or 

<CMD> <text> <-SCH> 



would have 



< INSERT MODE> 



Inserted characters 
or blanks where the 
cursor sat. 



Same. However/ when you 
hit the key/ you no longer 
see "INSERT MODE" on the 
line below the window. 
Now you see "INSERT" on 
the following line (the 
Info Line). Also/ you can 
use it to edit on the Command 
Line. 



<DEL CHAR> 



Deleted characters 
or blanks where the 
cursor sat. 



Same/ plus: 

You can use it to edit the 

Command Line. 
To remove text to right of 

cursor on current line/ hit 

<CMD> <DEL CHAR> 



<PUT> 



Put what was in the 
pick buffer/ or 
with the <ARG> key 
put what was in the 



Is now the <MARK> key 
(see <MARK> KEY section) 

To put the pick buffer/ 
type: 
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close buffer. 



<CMD> <PICK> 
or 

<GMD> -pick <RETURN> 
To put the close buffer, 
type: 

<CMD> <CLOSE> 
or 
<CMD> -Close <RETURN> 



<OPEN> 



< CLOSE > 



Inserted a blank line 
above the line inhere 
the cursor sat. 



Closed up the line 
where the cursor sat. 



Same. 

To open 4 lines/ type: 

<CMD> 4 <OPEN> 

or 

<CMD> open 4 <RETURN> 

Same . 

To close 2 lines* type: 

<CMD> 2 <CLOSE> 

or 

<CMD> Close 2 <RETURN> 



<PICK> 



<CTRL-S> 



Placed a line in the 
pick buffer without 
removing it from 
text. 



Moved the text window 

over to the right 

16 columns at a time. 



Same 
Or: 

<CMD> pick < RETURN > 
To pick 4 lines* type: 

<CMD> 4 <PICK> 

or 

<CMD> pick 4 <RETURN> 

Same. 

To move window over to 

column where cursor sits* type: 

<CMD> <CTRL-S> 



<CTRL-A> 



Moved the text window 

over to the left 

16 columns at a time. 



Same. 

To move window left all the way 

back to original position* type 

<CMD> <CTRL-A> 



<CTRL-B> 



Brought another file 
into the text window* 
and exchanged current 
file and alternate 
file. 



Now this only alternates between 
current file and alternate file 

To bring up another file 
by name* type: 
<CMD> e <filename> <RETURN> 



<CTRL-Z> 



<CTRL-C> 



Created a new window. 
With <arg>* closed 
most-recently-made 
window. 



Moved you from 



Now it moves you from 

window to window. 
To create a window* type: 

<CMD> window C<filename>3 <RETU 
To close last-made window* type: 

<CMD> -window <RETURN> 

Is now the "Interrupt Key" 



-13- 



window to window. 



(see "To Abort A Command" 
above ) . 
To move from window to 
window, type: 
<CTRL-Z> 



<CTRL-V> 



<CTRL-X> 



<CTRL-E> 



Updated file 
with present 
changes. 



on disk 
textual 



Executed unix programs 
when given with the 
<ARG> key. 



Set a new tab where 
the cursor sat* or 
with <ARG>* clear 
a tabstop* or with 
<ARG> filename* set 
tabs according to a 
file of tab settings. 



Has no meaning now. 
You can no longer update 
your file this way. You can 
save the file (with its present 
changes) to another filename 
by typing: 
<CMD> save <new filename> <RETl 

You can save your file in 
another directory by typing: 
<CMD> save <pathname> <RETURN> 

Has no meaning now. 

The most commonly used unix 

commands are now built-in 

commands* e.g. "fill". 
To run a system command* see 

"EXECUTE" section in Appendix C 

Same* except: 

To set tabs according to a 

tab file* type: 

<CMD> tabfile <file> <RETURN> 
There's more. See "TABS" sectio 

in Appendix C. 
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U. <MARK> KEY: FOR DEFINING AREAS WITH THE CURSOR 

Many commands* such as open and close* can operate on a number of 
lines or a rectangular area as defined by the cursor. The <MARK> key 
(previously known as the <PUT> key) allows you to "mark" such areas 
using the cursor. In ned* the <ARG> key was used for marking areas. 
Marking is much more flexible now that marking is done with a separate 
<MARK> key because now you can invoke functions requiring the <CMD> 
key to help you define your area — for example* moving off the current 
window or go to a certain line number. In fact* you can give just 
about any <CMD> key command you want while marking. 

You should play with marking using a scratch file until you feel 
comfortable with it. 

HOW TO MARK 

Hit the <MARK> key; this will mark the current cursor position. 
On the Info Line under the text window you will see "MARK 1"* which 
means you have marked 1 line. Now you can move the cursor and the 
window around to mark as many lines or as large a rectangle as you 
like. You can also use the <CMD> key freely as necessary to do things 
such as search for strings or go to the end of the file. All the 
while to the right of the "MARK" indicator you will see numbers noting 
how big an area you have defined. If you have marked a rectangle* you 
will see something like "MARK 180x40"* meaning 100 lines by 40 
co lumns. 

The area you have marked is defined between the current cursor 
position and the original cursor position (the beginning of your 
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marked area). To check the boundaries of the marked area> you can 
move the cursor back and forth between these two positions simply by 
hitting <MARK> again. This changes only the cursor position; the 
marked area/ as shown by the "MARK" numbers* remains the same. After 
moving back and forth between the limits of the marked area in this 
way, you can still continue to redefine the area as before. However, 
be careful to note the "MARK" indication, always making certain the 
cursor defines only the are.a you want. 

Now that you have marked the lines or rectangle you want, perform 
the operation you choose — either by hitting a function key (such as 
<CLOSE> to close the area you've marked) or by giving a command with 
the <CMD> key (such as "<CMD> center <RETURN>" to center the lines 
you've marked). When the command finishes execution the cursor will 
return to the upper-left corner of the area you marked. If necessary, 
the window will be moved so that the cursor can be put there. Also, 
after execution is completed, the marking (e.g., "MARK 100x40") will 
disappear. 

WARNING: Marking can be dangerous. If you forget that you have 
something marked, you can, for example, close a much bigger area than 
you intended. 



EXAMPLES OF MARKING COMMANDS 

Some marking examples are: 

<MARK> <cursor> <CLOSE> 

This will close the lines or the rectangle the cursor 

has defined and put the lines or rectangle into the 
<CLOSE> buffer. 

<MARK> <cursor> <OPEN> 

This will insert blank lines or a blank rectangle into 
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the area the cursor has defined. 

<MARK> <Cursor> <CMD> justify <RETURN> 

This will justify the lines the cursor has defined. 

<MARK> <CMD> <+PAGE> < CLOSE > 

This mill close up the lines between the original 
cursor position and the end of the file* which uias 
moved to with the +PAGE command. It will put the 
lines in the <CLOSE> buffer. 

<MARK> <CMD> goto <n> <RETURN> <CMD> justify <RETURN> 
This will justify the lines between the original 
cursor position and the line number you moved to with 
the goto command.. 



TO CANCEL MARKING 

If you want to cancel the marking you are doing/ type <CMDXMARK> 
There is a danger here: if you are giving commands via the <CMD> key 
while marking* you could accidentally cancel the marking. 

DESCRIBING AREAS ON THE COMMAND LINE 

Rather than using the <MARK> key/ you can designate an area by 

typing its size on the Command Line. To do so/ hit the <CMD> key/ type 

out the area you wish to define/ then hit the function key you wish. 

Examples: 

<CMD> 100X40 <CLOSE> 

This will close a rectangle 100 lines down by 40 columns 

across. 

<CMD> lp < CLOSE > 

This will close to the end of this paragraph. 

<CMD> 3 <OPEN> 

This will insert three blank lines. 

To designate an area to a typed-out command/ hit the <CMD> key/ 

type the command and the area/ then hit <RETURN>. 

Example: 
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<CMD> center 5L <RETURN> 
This will center five lines 
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VI. RECOVERY 



If the system crashed when you were in E, recovering your lost 
work is simple. When the system comes up again, change into the 
directory you were in when you started your crashed E session, and 
type "e" with no arguments whatsoever, including no filename. E will 
redo your lost session quietly. When it is done, the screen will be 
updated to the way it looked just before the crash. At that point, 
you should exit immediately to save your work, just as you would in 
ned. 

Ned used to allow you to watch a fast replay of your crashed 
session on the screen. E gives you that option. To get a recovery 
"movie" is not so simple. Refer to the following two sections in 
Appendix B: "Invoking E and Selecting Options" and "E's Work Files". 
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Appendix A 
SOME EDITING OPERATIONS 

Ned allowed you to give special editing commands, such as for 
doublespacing lines ("space") and sorting ("sort") by sending your 
text to a system command and replacing that text with the output of 
the system command. 

This capability has been retained and expanded by E. 

However, you no longer use <CTRL-X> to execute system commands. 
Now you use the "run" command with the <CMD> key: 

<CMD> run C<area>3 <system command> <RETURN> 
To see exactly how "run" works, note the examples of special editing 
commands below, plus some other useful editing operations. 

If you don't specify an <area> for the "run" command, the default 
is zero lines. If you give a number, it will be considered as a 
number of lines. (This is different from the ned <CTRL-X> which 
defaulted to 1 paragraph.) Therefore, if you want the command to work 
on a paragraph you must type "ip" or "ip- as the <area>. 

UNDERLINING 

You can underline in two ways, as you could before. 

a) To underline something short: If you wish to underline one 
word you can, as you have always been able to, type: 

<CTRL-\>H 
once for each letter, and then type an underline for each letter. 

b) To underline a line of text, move the cursor to that line, 
and then type the old underline command while invoking "run" with the 
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<CMD> key. 

That is: 

<CMD> run 11 just .ul <RETURN> 
This mill underline the current line. 

DOUBLESPACING 

If your file is singlespaced and you wish to doublespace or 
triplespace all or part of .it, use the old "space" command with the 
"run" command. -2 indicates doublespacing and -3 indicates 
triplespac ing. (As before, you cannot singlespace a doublespaced or 
triplespaced f i le. ) 

Some examples: 

<CMD> run 51 space -2 <RETURN> 

This will doublespace five lines down from the cursor. 

<CMD> run 2p space -3 <RETURN> 

This will triplespace two paragraphs down from the cursor. 

CHANGING TEXT TO ALL UPPER OR LOWER CASE 

Once again, this is done as it used to be, except you use the 

"run" command with the <CMD> key instead of using <CTRL-X>. To 

convert two paragraphs to upper case, type: 

<CMD> run 2p dd conv=ucase <RETURN> 

or 
<CMD> run 2p tr "Zz-zl" "CA-ZD" <RETURN> 

To convert one line to lower case, type: 

<CMD> run i dd conv=lcase <RETURN> 

or 
<CMD> run 1 tr "CA-Z3" "Ca-z3" <RETURN> 

This also converts the first letter of every sentence, so you must 
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change each one back by hand. 

USING THE TEE AND CAT COMMANDS FROM WITHIN E 

In ned* you might have used the "tee" and "cat" system commands 
uiith <CTRL-X> to move text from one file to another. You should not 
use those commands in this may in E. Their use is inherently tricky 
and can ruin your chances for a successful replay in the event of a 
crash. (This mas true in njed* too.) Rather* you should edit one file* 
pick from it the lines you want* then edit the second file and put the 
lines there. Noui that E lets you easily mark as many lines as you 
like* this should be a simpler way to accompl ish the same task anyway. 

INVOKING OTHER SYSTEM COMMANDS WHILE IN E 

As with ned* you can issue many system commands while you are 
still in E* inserting their output into the text window. Again* in 
ned you would use the <CTRL-X> key* but in E you use the "run" 
command. 

Since the default number of lines sent to the command and 
replaced by its output is zero in E* you can run ordinary system 
commands like "who" easily. 

Some examples: 

<CMD> run df <RETURN> 

This will list off disk space for all directories* the listing 

will begin where the cursor sits. 

<CMD> run df /flint < RETURN > 

This will list the disk space in /mat* the information will 

appear on the cursor line. 

<CMD> run Is <RETURN> 

This will list the files of the directory you are in. 
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Another new command similar to "run" is the "feed" command. It 
is just like the run command* but it doesn't close out the text that 
is sent to the system command. 

WARNING: Since the result of running many commands can be different 
depending on uihen you run them* you can ruin your chances for a 
successful replay in the event of a crash by using this feature. For 
example* say you run a "who" command and then close out the lines 
after looking at the result. Then you go on editing* and the system 
crashes. Now you try to recover* and when the "who" is issued at the 
time of the replay* there are fewer users on the system* and so there 
are fewer lines to close. The replay* however* goes on closing the 
lines as you did in the original session. The replay will have closed 
some lines it shouldn't have. 

FILL* JUSTIFY AND CENTER 

Fill* justify* and center are new built-in commands that should 

never be used with "run". First* invoking them with "run" is 

inefficient* and second* replay cannot be guaranteed. You should type 

these commands in the standard <CMD> key format as described in the 

<CMD> KEY section: 

<CMD> ju < RETURN > 
This will justify one paragraph. 

You can override the default line length of 75 columns by adding 

a width option of whatever line length you prefer. 

Example: 

<CMD> ju width=65 <RETURN> 

or 

<CMD> ju w=65 < RETURN > 
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This will justify one paragraph* giving it a line length 
of 65 columns. 

Whatever width you set becomes the default line length until you 

redefine it. The same line length will still be in effect if you exit 

and reenter E with no file arguments. 

REPLACING TEXT 

In ned you used the "rpl" system command with <CTRL-X>. E has a 
new "replace" command. Example: 

<CMD> replace 50 /right/left/ <RETURN> 

replaces the word "right" with the word "left" throughout the next 

fifty lines* including the current line starting at the cursor 

position. Here is the formal specification for the replace command: 

<CMD> replace C<area>3 Cshow3 /<strl>/C<str2>:i/ <RETURN> 
or or 

-replace C interact ive3 

where "/" represents the "string delimiter" and can be any printing 
character except letters* numbers* "." or "*". ("-replace" works 
backwards in the file.) If no <area> is given* then "all the way in 
the appropriate direction" is assumed. You can also mark an area for 
the replace commands. A forward replace starts with the first 
occurrence of <strl> on or after the current cursor position* and a 
backwards replace starts with the first occurrence of <stri> to the 
left of the current cursor position. 

<strl> is the "search string", and <str2> is the "replacement 
string". If <str2> is null* as in "replace /the//" then all 
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occurrences of the first string are deleted. You are given freedom to 
pick your own string delimiter so that any character can appear in a 
search or replacement string. 

Normally* a replacement is done quickly, all at once* and the 
only thing you will see happening on the screen is the replacements 
that are in your current window position. You can select the "show" 
option to show you all of the replacements as they are happening* and 
the window will move as necessary so that you can see them happen. 

The "interactive" option sets up the <REPLACE> key (old <GOTO> 
key) for interactive replacing. Here's what happens: An initial 
search for <strl> is attempted. If you specified an <area>* then the 
search is limited to within that area. The <+SEARCH> and <-SEARCH> 
are set to search for <strl>* and the <REPLACE> key is "armed" to do 
the replace you specified. If <stri> was found* you can do one of 
three things: 

.1. type <+SEARCH> or <-SEARCH> to skip to next instance of <strl> 

2. type <REPLACE> to do the replace 

3. abandon the replacing and go on to other editing 

The <REPLACE> key will remain "armed" until the next "replace" 
command. You can type it at any time* but it won't do anything unless 
the cursor is at an instance of <strl>. The <+SEARCH> and <-SEARCH> 
keys will stay set to search for <strl> until you use them to search 
for something else. 

An "interactive" or "show" option can be either before or after 
an <area> option on the Command Line. 
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You can use control characters in either <stri> or <str2> by 
using the appropriate <CTRL-\><char > sequence (e.g. <CTRL-\>L for 
form-feed). Newlines (<CTRL-s>J) are a special case, however. They 
cannot appear in the replacement string, and they can only appear at 
the beginning and/or end of the search string. 

RENAMING AND DELETING FILES 

Tuio other new commands have been added: 

name <newname> 

delete 
Each of these works on the current file. "Name" assigns a new name to 
that file upon exit, if possible. Delete marks it for deletion upon 
exit. Nothing really happens until exit, so that your edit session is 
replayable. 

WINDOWS 

To create a window, set the cursor where you want the window to 
appear, then type: 

<CMD> window <filename> <RETURN> 
where <filename> is the name of the file you want in the new window. 
The current file will become the alternate fi le of the new window. If 
you don't type a filename, the current file and alternate fi le (if 
any) will carry over to the new window, so you will have two windows 
of the same file. (Old ned used to bring up an empty default file.) 
Since E accepts abbreviations for commands, you could type: 

<CMD> w <filename> <RETURN> 
and get the same results. You can create up to ten windows, as in 
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ned. 

To move from window to window* type: 

<CTRL-Z> 
Windows are numbered in the order they were created* so you can 
go to the third window by typing: 

<CMD> 3 <CTRL-Z> 

To remove the last window you created* type: 

<CMD> -Window <RETURN> 

or 

<CMD> -w < RETURN > 

IYPING ON THE COMMAND LINE 

E lets you type <CTRL-\> on the Command Line and thus: You can 
search for strings with control characters in them! You can also use 
any number of occurrences of <CTRL-n>J or <CTRL-\>j in search strings 
to specify beginning-of-1 ine or end-of-line context. When used by 
itself as an argument to <+/-SEARCH>* <CTRL-\>J will find the ends of 
lines; <CTRL-s>J<CTRL-\>J finds blank lines. 

E lets you edit the Command Line much as you would edit a line in 
the text window. The key to this new facility is that you can use the 
left and right arrow keys on the Command Line as you would in the text 
window. All of the other stuff you can do with <INSERT MODE>* <BS>* 
and <DEL CHAR> are functional on the Command Line* too. Note that 
once you are on the command line* certain keys like <DEL CHAR> take on 
an alternate meaning when preceded by the <CMD> key* just as in the 
text window. For example* 

<CMD> <DEL CHAR> will erase the rest of the Command Line. 
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In addition to these features which work just as they do in the 
text window, there are two other useful features: 

<CMD> <CTRL-B> will bring up the Command Line as it was last 
time you typed on it/ and 

<CMD> <PICK> will insert into the Command Line the word 
pointed to by the cursor in the text window. ("word" here is all 
characters to the right of the cursor up to the first blank). 

The old/ easy way to s.earch for a string that already exists in 
your text still works: Go into the text window and set the cursor at 
the beginning of the string <a "string" here is all characters to the 
right of the cursor up to a blank); then hit: 

<CMD> <+SCH> This will move the cursor to the next occurrence 
of the string. It will also put that string into the searchkey buffer 
and the "last command" buffer. 

To execute commands given on the Command Line, the cursor need 
not be at the end of the typed-out command. It can be anywhere under 
the command when you type <RETURN>. However, if you are typing <CMD> 
<string> <+SRCH>, you can only get trailing spaces into the search 
string by having the cursor be after the last space when you type the 
<+SRCH> key. (Similarly for <-SRCH>, of course. 

PAGE EJECTS 

Page ejects are set the same way in E as in ned. Type: 
<CTRL-\>L 
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Appendix B 
ADVANCED AND MISCELLANEOUS TOPICS 

This section is basically for system programmers/ though there 
may be specialized information here just for you. If you're 
interested/ read on. If you don't understand something just skip it. 

LOGGING DIRECTLY INTO E/ BYPASSING UNIX SHELL 

Some users log directly into E without entering the UNIX shell. 
To deal uiith their special situation/ the following two new features 
were put in: 

If this user logs on when there is no state file to tell E what 
he was editing last/ E will create a file called "scratch" in the 
current directory. This file can be used as usual and will be saved 
on normal exit. (Ned would have put up a default file in that case 
with a message in it saying there was nothing to edit.) 

E login users are given a special way to get a shell to do things 
difficult or impossible to do from within E. For them the "shell" 
command has been created. While in E they can type: 

<CMD> Shell <RETURN> 
and this will move them into the shell without logging them off. When 
the shell exits/ they are prompted to hit <RETURN>/ which will take 
them back into E. E is reentered as if it had been invoked with no 
arguments. The new "call" command works similarly but allows the user 
to give one system command to be run by the shell before returning to 
E. 

Both of these commands go through the same sequence of updating 
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files, sawing the edit state, restoring tty modes, etc., that E mould 
do on a normal exit, but then they run a shell as a sub-process. Call 
runs the program with the given arguments. Shell/ if invoked uiith no 
arguments, runs an interactive shell. Shell with arguments is 
equivalent to using call. 

INVOKING E AND SELECTING OPTIONS 

If the system didn't crash while you were in E, invoking it with 
no arguments (just typing e) brings up all windows and alternate files 
from the last session, just as "ned ! " used to. (If there was a 
crash, this is the recovery procedure.) 

When you invoke E, you can specify some options; they should be 
typed in this order: 

e <options> <filename> 
The options are -help, -inplace, and -notracks, -replay, and -silent. 

If you type 

e -help <other option(s)> C<filename>3 
E will list out for you what options are available and put an asterisk 
next to the ones you just invoked, including defaults. 

Typing 

e -notracks <filename> 
will allow you to edit a file without using or disturbing the work 
files (keys, state, and change files) from your previous E. 

To use the -inplace option, see "Linking" below. 

Typing: 

e -replay 
will cause E to replay the last session. When replay is completed. 
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save by exiting as usual. 

Typing: 

e -repl ay=f i lename 
allows you to replay uiith a specified keys file, where "filename" 
represents that keys file. 

Typing: 

e -silent -replay 
allows you to replay the recovery* but E won't show you the replay. 
You will see the file after replay is completed. You can't invoke the 
-silent option without the -replay option. 

If you want to watch a crash recovery* you will use the "-replay" 
option, which will do the replay from the keys file made by the 
crashed session. You will have to do one more thing, however, before 
you can get a crash replay. You will have to delete the E's "changes" 
work file, i.e. the file it used for the changes during the crashed 
session. When you do a normal silent recovery by typing e with no 
arguments, E automatically removes its changes file. The sure way to 
find out the name of the changes file so you can delete it is to run 
"e -help". E will tell you the name of the changes file, and you can 
delete it. See also the section below on "E's Work Files". 

LINKED FILES 

If you make changes to a file that has multiple links, the normal 
updating procedure when you exit from E is as follows: your link to 
the file is renamed to ",<f i lename>" and the changed version is 
written out to a completely new file uiith only one link. Thus you 
won't disturb the file that everyone was originally linked to. 
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E gives you the option of updating so that the changes are made 
in the original file with all of the links. This is called updating 
"in place". What you need to do is set the "inplace" flag associated 
mith the file(s) you want updated that may. One may to do that is to 
run your E session with the "-inplace" option. That will make 
"inplace" the default method of updating all multilink files. Another 
way is to explicitly set the "inplace" flag for the filets) with E's 
new "update" command. 

<CMD> update inplace <RETURN> will set the "inplace" flag for 
the current file. 

<CMD> update -inplace <RETURN> will clear the "inplace" flag 
for the current file. 

<CMD> -update <RETURN> will make sure that no matter how many 
changes you have made or will make to the file, it won't be updated at 
all on exit. 

One more point on links. Say you are editing a file called "fl", 
and there is another file, "f2", linked to it, which is to say that 
that file is also known as f2. Now you type <CMD> edit f2 <RETURN>. 
E will know that f2 is just another name for fi, and what you will get 
is the exact file you are currently in with all the changes you've 
made. It will even have the name of your current file rather than of 
the other linked file. 
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E'S WORK FILES 

Since recovery is noui automatic* you needn't know about the work 
files (keys* state, and change files), but if you're interested read 
on. 

If you have write permission in the current directory, the state, 
keys, and change files are now in the current directory. If you are 
the owner of that directory, the files are named ".esl", ".ekl", and 
".eel" respectively. Also,, there is now a backup keys file called 
".eklb". During a recovery or a replay from the default keys file, 
this contains the key strokes from your previous editing session. If 
you are not the owner of the directory, your login name is appended as 
in ".ekl. day". If you don't have write permission in the current 
directory, your work files are in /trnp/etrnp/ (like the old 
•vtrnp/nedtrnp" ), with names (based on your login name) such as kl.day, 
si. day, and cl.day . 

When E exits normally, it writes out a state file containing 
information such as which file you were editing, where you were in it, 
and so on. The state file now saves more information than it used to, 
including the search string, the state of Insert Mode, the time the 
session started, and the last "width=n" argument to fill, justify, or 
center. E uses the state file information to set you up in the same 
edit environment you were when you exited. In ned, if you took an 
abort exit the state file would be updated. That's no longer true. 
As before, "e filename" edits that filename and ignores the state 
file. 

Saving your editing environment in your current directory 
considerably speeds up entering and exiting E. It also allows you to 
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go back and -forth between different environments depending on the 
directory you are in, and it makes it easier to guarantee that you are 
in the right directory to do a reliable replay. As a result of this 
new policy, and to keep from proliferating useless files, the 
keystroke file is deleted on normal exit. It is not removed when the 
system crashes, when you exit with the dump option, or when you exit 
with the abort option, however. The change file is removed except 
when the system crashes or .when you exit with the dump option. 

If you exit with the abort option, the state file is not 
disturbed and the keys file, as noted above, is not removed. 
Therefore, if you have a good edit session except for your last 
command, which somehow destroyed your file, you can recover that 
session by typing 
e -replay 
and interrupt the replay before that last command replays. It is 
recommended that you interrupt with either the interrupt: 

<CTRL-C> 
or by hitting the <CMD> key. 

A revision number is put out as the first two bytes of the state 
file and keys file. Also a number telling the type of terminal you 
were at during the session is put out as the second and third bytes of 
the state file and keys file. E now checks that the revision number 
and terminal screen size in the state file (if used) and the keys file 
(if replaying or recovering) match the current revision. If not, E 
complains and stops. 

The keys that you type go through a translation stage before they 
are written to the keys file, so that the codes that are put into the 
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keys -file tell what you typed regardless of uihat type of terminal you 
were on. 

An interrupt (<CTRL-C>) that doesn't interrupt anything is not 
put out to the keys file. 

The new commands fill* justify* and center take an optional 
"width=n" argument* which is remembered in the state file until the 
next time it is set. Recent versions of the fill and just programs 
kept a file for each user in /tmp/nedtmp/ that kept the last-used line 
length. Those files are not used any more. 

FILES AND DIRECTORIES 

If you try to edit a file that doesn't exist and you answer 
affirmative to the question as to whether you want to create it* the 
file is NOT actually created at that time* as it used to be in ned. 
The file will only be created when and if you do a normal exit which 
does a permanent save. It used to be that ned created an empty file 
until you exited* when it put the text in. That's why you had to 
remove the unsaved file from your directory before recovering. E 
makes the creating of files replayable* no longer necessitating the 
removal of unsaved files from your directory before recovering. Also* 
a zero-sized backup file is no longer created. 

Files used to always be created with protection mode "rui-r — i ". 

Now it is "rw-i 1 •• if groupid = i (which is the case for most users). 

Otherwise the mode is "rw-rw-r — ". 

File and directory permission checking for "save" and "edit" is 
completely rewritten. You can edit directories but you can't modify 
them. You aren't allowed to edit devices (also known as special 
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files) or save-to them. You aren't allowed to try to save to a 

directory. You can't modify a file or create a file if you can't 
write in the directory. 

In UNIX Version 7* the "SHELL" environment variable is used to 

find the appropriate shell for you. In version 6, if there is a "sh" 
in the current directory* it is used as the shell. Otherwise "sh" is 

in your private bin* otherwise it's in 'Vbin/sh". 

NEW COMMANDS AND OTHER CHANGES 

The save command can now only be used for saving to files not 
already held internally by E. "Save" with no argument is now illegal. 

If you type an interrupt* but there was nothing to interrupt* E 
will tell you that. <CTRL-C> interrupts searches and the commands 
run* feed* fill* just* and center. 

The "run" and "feed" commands now always work by invoking the 
shell* so all of the special characters like ? * and : you type in 
arguments to the system command are interpreted by the shell. You 
should never explicitly invoke the fill* justify and center commands 
with "run". 

Two new commands are: 

call <program> C<args>3 
shell C<args>] 
To see more on them* refer to "Users Who Log Directly Into E* 
Bypassing the UNIX Shell" above. 

If an "edit" or "window" command is given with a filename which 
is already held internally* the file will come up on the screen at the 
same window position and cursor position within the window as the last 
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time you saw it. 

<CTRL-B> is now only usable to change from current file to 
alternate file. Instead of 

<CMD> filename <CTRL-B> 

type 

<CMD> edit <filename> < RETURN > 
Ned's <ARG> <CTRL-B> feature was getting naive users into terrible 
trouble when they invoked i.t by accident, and it has been withdrawn. 

The cursor position after <+/-page> and <+/-LlNE> and goto is 
different. The column position is preserved except for a goto to line 
1, when the cursor is put "home". <+/-PAGE> leaves the cursor in the 
same place on the screen. <+LINE> will leave the cursor at the 
uppermost line in the window if the line the cursor was on is no 
longer visible. (Similarly for <-LINE>.) 



-39- 

Appendix C 
SUMMARY OF FUNCTIONS IN E, LISTED BY TOPIC 



FUNCTION 

ARGUMENT 

ABORT 
Abort and 
exit 

Abort a 
<MARK> 
command 

Abort a 
<CMD> command 

Get off the 
Command Line 

ALTERNATE FILE 
Change text 
window to 
alternate 
file 

CENTER 
Center 1 line 

Center n lines 

Center n 
paragraphs 

CHANGE 
Change windows 

Change to 
<n>th created 
window 

Change to 
alternate 
f i le 

Change the 
name of the 
current file 



OLD WAY 
<ARG> 

<ARG> a <DEL> 

Nonexistent. 

Nonexistent. 
Nonexistent. 

<CTRL-B> 



<ARG> 11 center <CTRL-X> 
<ARG> <n>l center <CTRL-X> 
<ARG> center <n> <CTRL-X> 

<CTRL-C> 

<ARG> <n> <CTRL-C> 

<CTRL-B> 

Nonexistent. 



NEW WAY 
<CMD> 

<CMD> ex a <RETURN> 

<CMD> <MARK> 

<CTRL-C> 
<CMD> < RETURN > 



<CTRL-B> 

or 

<CMD> e <RETURN> 



<CMD> ce <RETURN> 
<CMD> ce <n> <RETURN> 
<CMD> ce <n>p < RETURN > 

<CTRL-Z> 

<CMD> <n> <CTRL-Z> 



<CTRL-B> 

or 

<CMD> e < RETURN > 

<CMD> n <filename> <RETURN> 



CLEAR THE SCREEN Nonexistent, 



<CMD> redraw <RETURN> 



AND REDRAW 
WINDOW TO DELETE 
SYSTEM MESSAGES 
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CLOSE 
Close 1 line 



Close 4 lines 



Bring 1 line 
up to end of 
another (join 
2 lines) 



< CLOSE > 



<ARG> 4 < CLOSE > 



<ARG> < CLOSE > 



< CLOSE > 

or 

<CMD> clo < RETURN > 

<CMD> 4 < CLOSE > 

or 

<CMD> ClO 4 < RETURN > 

<CMD> jo < RETURN > 

or 

<CMD> -sp <RETURN> 



Close lines or 
rectangle 



Close area but 
don't move 
rest of text 
(erase) 



<ARG> <cursor> <CLOSE> 



Nonexistent. 



<MARK> <cursor> <CLOSE> 

or 

<CMD> <area> <CLOSE> 

or 

<CMD> clo <area> <RETURN> 

<CMD> er <area> <RETURN> 



COMMAND MODE 

CREATE WINDOWS 
Create window 
with new 
file in it 



Nonexistent. 



<ARG> <f i lename> <CTRL-Z> 



<CMD> CO < RETURN > 



<CMD> w <fiiename> < RETURN > 



Create window 
with current 
file in it 



<ARG> <curf i lename> <CTRL-Z> 
Didn't take alternate file 
with it. 



<CMD> w < RETURN > 

Takes alternate file with i 



CURSOR 
Move cursor to 
line 1, 
column l 



<HOME> 



<HOME> 



Move cursor to 
bottom line of 
of screen^ 
column 1 



Nonexistent. 



<CMD> <HOME> 



Move cursor to 
end of text 
on current 



Nonexistent. 



<CMD> <right arrow> 



I ine 
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Move cursor to 
last column 
of current 
1 ine 



Nonexistent 



<CMD> <right arrow) 
(repeat if necessary) 



Move cursor to 
column l, 
current line 



Nonexistent 



<CMD> < left arrow) 



Move cursor to 
bottom line of 
screen* cursor 
column 



Nonexistent 



<CMD> <dou>n arroui> 
(repeat if necessary 
at end of file) 



Move cursor to 
line I* current 
co lumn 



Nonexistent, 



<CMD> <up arrow) 



DEFINE AREA 

DELETE 
Delete current 
file upon 
exit 



<AR6> <cursor> (function key> <MARK> (cursor) (function i 



Nonexistent. 



<CMD> del <RETURN> 



Delete 
individual 
characters 



<DEL CHAR) 



<DEL CHAR> 



Delete last 
window 
created 



<ARG> <CTRL-Z> 



<CMD> -w < RETURN > 



DUMP EXIT 

EDIT A FILE 
Bring up a 
file into 
text window 



Nonexistent. 



<ARG> <filename> <CTRL-B> 



<CMD> ex d <RETURN> 



<CMD> e <filename> (RETURN: 



ERASE AREA 

WITHOUT MOUING 
REST OF TEXT 



Nonexistent. 



<CMD> er (area) (RETURN) 



EXECUTE 
Execute some 
function 



(ARG> (function) (CTRL-X) (CMD) run ip (func) (RETURb 

or or 

(ARG) (n> (func) (CTRL-X) (CMD) run (n)p (func) (RETL 

or or 

(ARG) (n)l (func) (CTRL-X) (CMD) run (n) (func) (RETUR 
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Execute some 
function 
without 
closing 

EXIT 
Exit and save 



<ARG> <n> tee <CTRL-X> 
<ARG> <CLOSE> 



<CMD> feed ip <func> <RETUF 



Exit and abort 

Exit and dump 

Exit* then 
execute load 

"FEED" IS LIKE 
RUN BUT DOESN'T 
CLOSE 

FILE 
Bring up 
alternate file 
into text 
window 

Change text 
window to 
alternate 
file 

Create window 
with new 
file in it 

Change windows 

Change to 
<n>th created 
window 

Change the 
name of the 
current file 

Create window 
with current 
file in it 



<DEL> 



<ARG> a <DEL> 
Nonexistent. 
<ARG> <DEL> 

Nonexistent. 



<ARG> <filename> <CTRL-B> 



<CTRL-B> 



<ARG> <filename> <CTRL-Z> 

<CTRL-C> 

<ARG> <n> <CTRL-C> 

Nonexistent . 



<ARG> <filename> <CTRL-Z> 
Didn't take alternate file 
with it. 



<CMD> ex < RETURN > 

or 

<CMD> bye <RETURN> 

or 

<CMD> logoff <RETURN> 

<CMD> ex a < RETURN > 

<CMD> ex d <RETURN> 

<CMD> ex 1 <RETURN> 

See "EXECUTE" above. 



<CMD> e <f i 1 en ame>< RETURN: 



<CTRL-B> 

or 

<CMD> e < RETURN > 



<CMD> w <filename> < RETURN: 

<CTRL-Z> 

<CMD> <n> <CTRL-Z> 

<CMD> n <filename> < RETURN: 



<CMD> w < RETURN > 

Takes alternate file with i 



Delete current 



Nonexistent. 



<CMD> del <RETURN> 



-43- 



file upon 
exit 

Delete last 
window 
created 

Exit and save 



Exit and abort 

Exit and dump 

Exit/ then 
execute load 

Save current 
changes onto 
backup f i le 

Save current 
changes as a 
second file 

Save file in 
another 
directory 



<ARG> <CTRL-Z> 



<DEL> 



<ARG> a <DEL> 
Nonexistent . 
<ARG> <DEL> 

<CTRL-V> 

Nonexistent. 

<ARG> <pathname> <CTRL-V> 



<CMD> -u» < RETURN > 

<CND> ex <RETURN> 

or 

<CMD> bye <RETURN> 

or 

<CMD> logoff <RETURN> 

<CMD> ex a <RETURN> 

<CMD> ex d <RETURN> 

<CMD> ex 1 <RETURN> 

No equivalent now. 

<CMD> sa <neui filename> <Rl 

<CMD> sa <pathname> <RETURI 



FILL 
Fill n lines 



Fill i 
paragraph 

Fill n 
paragraphs 

Fill 3 

paragraphs 
overr iding 
default line 
length 



<ARG> <n>l fill <CTRL-X> 

<ARG> fill <CTRL-X> 

<ARG> <n> fill <CTRL-X> 

<ARG> 3 fill ".11 65" 

<CTRL-X> 



GOTO 
Goto beginning <GOTO> 



<CMD> fi <n>l <RETURN> 

or 

<MARK> <cursor> <CMD> fi <F 

<CMD> fi < RETURN > 



<CMD> fi <n> < RETURN > 



<CMD> fi 3 ui = 65 <RETURN> 
or 

<CMD> fi uj = 65 3 <RETURN> 
or 

<MARK> <cursor> <CMD> fi tu = 

<RETUR 



<CMD> <-PAGE> 
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Of file 



Goto end of 
file 



Goto specific 
line number 



<ARG> <GOTO> 



<ARG> <n> <GOTO> 



or 

<CMD> g <RETURN> 

or 

<CMD> g b <RETURN> 

<CMD> <+PAGE> 

or 

<CMD> g e < RETURN > 

<CMD> g <n> < RETURN > 



INPLACE UPDATING 
Set inplace 
update mode 

Clear inplace 
update mode 

INSERT 
INDIVIDUAL 
CHARACTERS 



Nonexistent 



Nonex istent 



< INSERT MODE> 



<CMD> u i < RETURN > 



<CMD> u -i < RETURN > 



< INSERT MODE> 



JUSTIFY 
Justify n 
1 ines 



Justify i 
paragraph 

Justify n 
paragraphs 

Justify 3 
paragraphs 
overriding 
default line 
length 



1ARK AREA 
WITH CURSOR 



<ARG> <n>l just <CTRL-X> 



<ARG> just <CTRL-X> 



<ARG> <n> just <CTRL-X> 



<ARG> 3 just ". 1 1 65" 

<CTRL-X> 



<CMD> ju <n>l <RETURN> 

or 

<MARK> <cursor> <CMD> ju <R 

<CMD> ju < RETURN > 



<CMD> ju <n> <RETURN> 



<CMD> ju 3 Ul = 65 < RETURN > 
or 

<CMD> ju «B = 65 3 <RETURN> 
or 

<MARK> <cursor> <CMD> ju w= 

<RETUR 



<ARG> <cursor> <function key> <MARK> <cursor> <function k 



10UE TEXT WINDOW 
Move text 

uiindoui to 

the right 

Move text 
window to 
the left 



<CTRL-S> 



<CTRL-A> 



<CTRL-S> 



<CTRL-A> 
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Move right so Nonexistent, 
that cursor 
column becomes 
left column 



<CMD> <CTRL-S> 



Move all the 
way back to 
the left 



Nonexistent. 



<CMD> <CTRL-A> 



OPEN 
Open 1 line 



<OPEN> 



<OPEN> 

or 

<CMD> o <RETURN> 



Open n lines 



<ARG> <n>. <OPEN> 



<CMD> <n> <OPEN> 

or 

<CMD> o <n> < RETURN > 



Open 
rectangle 



<ARG> <cursor> <OPEN> 



<MARK> <cursor> <OPEN> 

or 

<CMD> <area> <OPEN> 

or 

<CMD> o <area> < RETURN > 



Open a line 
in the 
middle 
(split 1 
line in 2) 



<ARG> <OPEN> 



<CMD> sp < RETURN > 

or 

<CMD> -j < RETURN > 



PICK 
Place 1 line <PICK> 
in pick buffer 



Place 4 lines <ARG> 4 <PICK> 
in pick buffer 



Place lines or <ARG> <cursor> <PICK> 
rectangle in 
pick buffer 



PUT 
Put pick 
buffer 



Put close 
buffer 



<PUT> 



<PUT> < CLOSE > 



<PICK> 

or 

<CMD> pi < RETURN > 

<CMD> 4 <PICK> 

or 

<CMD> pi 4 < RETURN > 

<MARK> <cursor> <PICK> 

or 

<CMD> <area> <PICK> 

or 

<CMD> pi <area> < RETURN > 



<CMD> <PICK> 

or 

<CJ1D> -p < RETURN > 

<CMD> < CLOSE > 

or 

<CMD> -c < RETURN > 
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Put erase 
buffer 



Nonex istent 



<CMD> -e < RETURN > 



REDRAW THE 
SCREEN CLEARING 
SYSTEM MESSAGES 

"RUN" EXECUTES 
COMMANDS 

SAVE 
Save current 
changes onto 
backup file 

Save current 
changes as a 
second f i le 



Nonexistent . 



<CTRL-X> 



<CTRL-U> 



Nonex istent. 



<CMD> red <RETURN> 



<CMD> run C<area>3 <commanc 
Coptions] <RETURh 



No equivalent now. 



<CMD> sa <neui filename> <RE 



Save file in 
another 
directory 

Ensure update 
of current 
file on exit 



<ARG> <pathname> <CTRL-U> 



Nonexistent 



<CMD> sa <pathname> <RETURh 



<CMD> U < RETURN > 



Prevent update 
of current 
file on exit 

Set inplace 
update mode 

Clear inplace 
update mode 

TAB 
Set a tabstop 



Nonexistent 



Nonexistent 



Nonexistent 



<S/R TAB> 



Clear a tabstop <S/R TAB> 



Set tabs 
according to 
a file of 



<ARG> <file> <S/R TAB> 



<CMD> -u <RETURN> 



<CMD> u i < RETURN > 



<CMD> U -i < RETURN > 



<S/R TAB> 

or 

<CMD> tab < RETURN > 

or 

<CMD> tab <column«> <RETURN 

<CMD> <S/R TAB> 

or 

<CMD> -tab < RETURN > 

or 

<CMD> -tab <coiumn»> <RETUR 

<CMD> tabfile <file> <RETUR 
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tabstops 

Set tabs every 
<n> columns 



<ARG> <n> <S/R TAB> 
worked for some <n>'s 



<Cf1D> tabs <n> <RETURN> 



Set tabs every 
<n> columns 
within a 
range of 
columns 



Nonexistent 



<MARK> <right or left arrou 
<CMD> tabs <n> <RETURN> 



Clear tabs 
on every <n> 
columns 



Nonexistent 



<CMD> -tabs <n> <RETURN> 



Clear tabs every Nonexistent 
<n> columns 
within a 
range of 
columns 



<MARK> <right or left arrou 
<CMD> -tabs <n> < RETURN > 



Clear all 
tabstops 

C 1 e ar all 
tabstops 
within a 
range of 
columns 



Nonexistent 



Nonexistent 



<CMD> -tabs < RETURN > 



<MARK> <right or left arrou 
<CMD> -tabs < RETURN > 



TEE 



<AR6Xn>l tee <name><CTRL-X> 



<CMD> <n> <PICK> 
<CMD> e <name> 
<CMD> <PICK> 



UPDATE 
Ensure update 
of current 
file on exit 



Nonexistent 



<CMD> U < RETURN > 



Prevent update 
of current 
file on exit 



Nonexistent 



<CMD> -U < RETURN > 



Set inplace 
update mode 

Clear inplace 
update mode 



Nonexistent 



Nonexistent 



<CMD> u i < RETURN > 



<CMD> U -i < RETURN > 



NINDOWS 
Create window 
with new 
file in it 



<ARG> <filename> <CTRL-Z> 



<CMD> w <filename> <RETURN) 
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Create window 
with current 
file in it 

Change windows 

Change to 
<n>th created 
window 

Delete last 
window 
created 



<ARG> <filename> <CTRL-Z> 
Didn't take alternate file 
with it. 

<CTRL-C> 

<ARG> <n> <CTRL-C> 



<ARG> <CTRL-2> 



<CMD> w <RETURN> 

Takes alternate file with 



<CTRL-Z> 

<CMD> <n> <CTRL-2> 

<CMD> -W < RETURN > 
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Appendix D 
SUMMARY OF FUNCTIONS IN E, LISTED BY 

FUNCTION 



OLD WAY 
<ARG> 

<ARG> <ARG> 

<ARG> <command> <ARG> 

<ARG> 5 <right arroui> 

<ARG> 5 <left arroui> 

<ARG> 5 <up arrou>> 

<ARG> 5 <doum arrou»> 

<ARG> 11 center <CTRL-X> 
<ARG> <n>l center <CTRL-X> 
<ARG> center <CTRL-X> 

< CLOSE > 

<ARG> <n> < CLOSE > 

<ARG> < CLOSE > 



<ARG> <cursor> <CLOSE> 



To enter the 
Command Line 

To get off the 
Command Line 

To get off the 
Command Line 

Move the cursor 
5 columns to 
the right 

Move the cursor 
5 columns to 
the left 

Move the cursor 
5 lines up 

Move the cursor 
5 1 ines down 

Center 1 line 

Center n lines 

Center i 
paragraph 

Close a line 



Close n lines 



Bring 1 line 
up to end of 
another (join 
2 lines) 

Close lines or 
rectangle 



OLD WAY IN NED 
NEW WAY 
<CMD> 

<CMD> < RETURN > 

<CMD> <command> <CTRL-C> 

No equivalent. 

No equivalent. 

<CMD> 5 <up arro«i> 

<CMD> 5 <douin arrou»> 

<CMD> ce 1 <RETURN> 
<CMD> ce <n> <RETURN> 
<CMD> ce lp < RETURN > 



< CLOSE > 

or 

<CMD> ClO < RETURN > 

<CMD> <n> < CLOSE > 

or 

<CMD> clo <n> <RETURN> 

<CMD> jo < RETURN > 

or 

<CMD> -sp <RETURN> 



<MARK> <cursor> <CLOSE> 

or 

<CMD> <area> <CLOSE> 

or 
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<CTRL-A> 



<CTRL-B> 



<ARG> <CTRL-B> 



<ARG> <filename> <CTRL-B> 

<CTRL-C> 

<ARG> <n> <CTRL-C> 

<CTRL-S> 

<CTRL-U> 

<ARG> < pathname > <CTRL-U> 

<ARG> <CTRL-Z> 

<ARG> <filename> <CTRL-Z> 

<ARG> <fiiename> <CTRL-2> 

<ARG> <cursor> <func key> 



Move text 
window to 
the left 

Change text 
window to 
alternate 
file 

Bring up filename 
at cursor 
into text 
window 

Bring up file 
into text 
window 

Change windows 

Change to 
<n>th created 
window 

Move text 
window to 
the right 

Update current 
changes into 
current 

Save file in 
another 
directory 

Delete last 
window 
created 

Create window 
with new 
file in it 

Create window 
with current 
file in it 

Define area 
with cursor 



<CMD> clo <area> <RETURN> 
<CTRL-A> 



<CTRL-B> 

or 

<CMD> e < RETURN > 



<CMD> e <CMD> <PICK> <RETUP 



<CMD> e <filename> < RETURN: 

<CTRL-Z> 

<CMD> <n> <CTRL-Z> 

<CTRL-S> 

No equivalent now. 

<CMD> sa <pathname> <RETURN 

<CMD> -w < RETURN > 

<CMD> w <filename> < RETURN > 



<CMD> w < RETURN > 

Takes alternate file with i 



<MARK> <cursor> <function k 
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<ARG> <cursor> <ARG> 



<CTRL-X> 



<ARG> <function> <CTRL-X> 

or 

<ARG> <n> <func> <CTRL^X> 

or 

<ARG> <n>l <func> <CTRL-X> 

<DEL> 



<ARG> <DEL> 
<ARG> a <DEL> 
<DEL CHAR> 

<ARG> fill <CTRL-X> 
<ARG> <n> fill <CTRL-X> 
<ARG> <n>l fill <CTRL-X> 



<ARG> 3 fill ".11 65 

<CTRL-X> 



<GOTO> 



Abort a defined 
area 

Execute 
commands 

Execute some 
function 



Exit and save 



Exit, then 
execute load 

Exit and abort 
changes 

Delete 
individual 
characters 

Fill l 
paragraph 

Fill n 
paragraphs 

Fill n lines 



Fi 11 3 
paragraphs 
overriding 
default line 
length 



Goto beginning 
of file 



<ARG> <GOTO> 



Goto end of 
file 



<MARK> <cursor> <CMD> <MARI- 



<CMD> run C<area>3 <commanc 

<RETUF 

<CMD> run lp <func> <RETURh 

or 

<CMD> run <n>p <func> <RETL 

or 

<CMD> run <n> <func> <RETUR 

<CMD> ex < RETURN > 

or 

<CMD> bye <RETURN> 

or 

<CMD> logoff <RETURN> 

<CMD> ex 1 <RETURN> 



<CMD> ex a <RETURN> 



<DEL CHAR> 



<CMD> fi < RETURN > 



<CMD> fi <n> < RETURN > 



<CMD> fi <n>l <RETURN> 

or 

<MARK> <cursor> <CMD> fi <R 

<CMD> fi 3 w=65 <RETURN> 
or 

<CMD> fi u» = 65 3 < RETURN > 
or 

<MARK> <cursor> <CMD> fi u» = 

<RETUR 

<CMD> <-PAGE> 

or 

<GMD> g <RETURN> 

or 

<CMD> g b < RETURN > 

<CMD> <+PAGE> 
or 
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(ARG) <n> <GOTO> 



(HOME) 



< INSERT MODE> 



(ARG) just (CTRL-X) 



<ARG> <n> jUSt (CTRL-X) 



(ARG) (n)l just <CTRL-X> 



<ARG> 3 just ". 1 1 65" 

(CTRL-X) 



<OPEN> 

(ARG) <n> <OPEN> 

<ARG> <CUPSOT> <OPEN> 



<ARG> <OPEN> 



Goto specific 
line number 

Move cursor to 
line lr 
column l 

Insert 
individual 
characters 

Justify 1 
paragraph 

Justify n 
paragraphs 

Justify n 
1 ines 



Justify 3 
paragraphs 
overriding 
default line 
length 



Open i line 
Open n lines 



Open 
rectangle 



<PICK> 



Open a line 
in the 
middle 
(split ' 1 
line in 2) 

Place 1 line 
in pick buffer 



(CMD) g e <RETURN> 
<CMD> g <n> < RETURN > 

<HOME> 

< INSERT MODE) 

<CMD> ju < RETURN > 

(CMD) ju <n> <RETURN> 

<CMD> ju <n>l <RETURN> 

or 

<MARK> (cursor) <CMD> ju <t 

<CMD> ju 3 u» = 65 < RETURN > 
or 

(CMD) ju UJ = 65 3 <RETURN> 
or 

<MARK> (cursor) <CMD> ju 10: 

(RETUf 

<OPEN> 

(CMD) <n> <OPEN> 

or 

<CMD> O <n> < RETURN) 

(MARK) (cursor > <OPEN> 

or 

<CMD> (area) (OPEN) 

or 

(CMD) o (area) (RETURN) 

(CMD> sp (RETURN) 

or 

(CMD) -j (RETURN) 



(PICK) 

or 

(CMD) pi (RETURN) 



(ARG) 4 (PICK) 



Place 4 lines 



(CMD) 4 (PICK) 
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in pick buffer or 

<CMD> pi 4 < RETURN > 

<ARG> <cursor> <PICK> Place lines or <MARK> <cursor> <PICK> 

rectangle in or 

pick buffer <CMD> <area> <PICK> 

or 
<CMD> pi <area> <RETURN> 

<PUT> Put pick <CMD> <PICK> 

buffer or 

<CMD> -p < RETURN > 

<PUT> <CLOSE> Put close <CMD> <CLOSE> 

buffer or 

<CMD> -c < RETURN > 

<S/-R TAB> Set a tabstop <s/R TAB> 

or 

<CMD> tab < RETURN > 
or 
<CMD> tab <columntt> <RETURN 

<S/'R TAB> Clear a tabstop <CMD> <S/R TAB> 

or 

<CMD> -tab < RETURN > 
or 
<CMD> -tab <column*»> <RETUR 

<ARG> <file> <S/R TAB> Set tabs <CMD> tabfile <file> <RETUR 

according to 
■ a file of 
tabstops 

<ARG> <n> <S/'R TAB> Set tabs every <CMD> tabs <n> <RETURN> 

(ojorked for some <n>'s) <n> columns 

<ARG> <n>l tee Tee/ create <CMD> <n> <PICK> 

<neui filename> <CTRL-X> new file from <CMD> e <ne« filename> 

old without <CMD> <PICK> 
closing 



-55- 

Appendix E 
CHART OF <CMD> KEY COMMANDS 

Below is a list of the words now recognized as commands by the 
<CMD> key. Acceptable abbreviations are indicated with underlining. 
In some cases* the number of required characters is more than you 
might expect. That is because we already know. what some of the future 
commands will be, and we don't want you to have to relearn the 
abbreviations when they are introduced. Upper and lower case are 
accepted for commands and command options. An asterisk denotes 
something you couldn't do before. 

bye Same as. exit (see below). 

♦c_a 1 1 <command> Users who log into E can give a shell command. 

center Centers area you marked or typed out. 

c_lose Closes up area and puts it in "close" buffer, 

♦command Puts you into Command Mode, 

♦delete Deletes current file upon exit. 

e_ C<filename>3 Guaranteed unambiguous synonym for "edit" 

edit <filename> Calls up <filename> into text window. 

e_dit Alternates between files, 

♦erase Erases area but does not move rest of text. 

exit Exits you from E and updates files. 

exit abort Exits without updating. 

exit dump Simulates crash; for editor testing. 

exit .load Exits and compiles; for software development, 

♦feed Like run but doesn't close. 

f_i 1 1 Fills text for rough right margin. 

goto Moves text window to beginning of file. 

goto b. Moves text window to beginning of file. 

§pto f_ Moves text window to end of file. 

goto <linett> Moves cursor to specific line number. 

loin Joins current line with line below at cursor. 

justify Justifies text for even right margin. 

logoff Same as exit. 

n_ame <newname> Changes name of current file upon exit. 

open Puts blank area into area you marked or typed. 

p_ick Picks area and puts in "pick" buffer, 

♦redraw Redraws window, eliminating system messages, 

♦replace Replaces words or strings throughout text. 

run Executes system commands. 

s.ave <filename> Saves current file to <filename>. 

♦shell Run a shell as a sub-process. 

split Splits line at cursor. 

lab set tab<s). 

t,abfile <filename> Set tabs according to tab file. 

♦t.abs <intervaltt> Set tabs every <interval8> columns, 

♦update Ensure updating of current file on exit, 

♦update i/iplace Set inplace update flag for current file, 

♦update -inplace Clear inplace update flag for current file. 

window Makes a new window into current file 
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window 

-close 
*-comman 
*-erase 

-join 

-£ick 
*-replac 

-spl it 

-tab 
*-t.abs 
*-update 

-window 



<f i lename > 
d 



Creates window of specified file. 

Puts "close" buffer. 

Moves cursor from Command Line into text window. 

Puts "erase" buffer. 

Same as split. 

Puts "pick" buffer. 

Replace text. 

Same as join. 

Remove tab 

Remove tabs 

Prevent update of current file on exit. 

Closes up last window created. 
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Appendix F 
CHANGES FROM REVISION 9 

The editor now looks ahead for <CTRL-C> from the terminal, so 
that if you are doing a search, then type some keys other than <CTRL- 
C>, then type a <CTRL-C>, the search will be interrupted and ail the 
keys you typed between the search and the <CTRL-C> are thrown away. 
E9 would have interrupted only the function immediately preceding the 
<CTRL-C> in the keystroke stream. 

The remaining changes in E10 over E9 are related to the handling 
of terminals, and the normal user need not read further. 

Earlier versions of ned and E wrote keys out to the keys file one 
key behind. Thus the keystroke that caused an editor crash was never 
in the keys file, and couldn't be read in on a replay or recovery to 
crash you again. E10 doesn't do this write-behind to the keys file. 
Instead, it refrains from replaying the last keystroke in the keys 
file so that you won't crash again. 

More than one kind of terminal can be handled by the same copy of 
the editor. This is handled by compiied-in code in the editor, and 
presently works only on version 7 unix systems using the environment 
variable "TERM". Presently handled types of terminals and the values 
for TERM to operate with them are: 

TERM Terminal type 

aa Ann Arbor 40x80 terminal 

3a Lear Siegler ADM3a 

31 Lear Siegler ADM31 

kl Heathkit H89 



